home *** CD-ROM | disk | FTP | other *** search
/ SPACE 2 / SPACE - Library 2 - Volume 1.iso / utility / 523 / stree102 / read.me < prev    next >
Text File  |  1991-05-05  |  25KB  |  672 lines
  1.               STree - The ST Filetree Scan Utility
  2.               ====================================
  3.  
  4.                           Version 1.02
  5.                   Written by Stephen Hebditch
  6.                   (C) 1991 TQM Communications
  7.  
  8.                              ------
  9.  
  10.  
  11. There's a file you *know* is on your hard disk somewhere but you 
  12. can't remember just where. Looks like it's time to dig out that 
  13. unfriendly TTP file finder. If you can remember where that is, 
  14. and what you're supposed to type in the launch box.
  15.  
  16. Or maybe installing a big new application has gone wrong. It 
  17. seems to have created new folders and files on several 
  18. partitions, but you're not sure what they're called or where 
  19. they are. Looks like you'll have use the desktop to check each 
  20. folder in turn. Or perhaps you could dig out that command line 
  21. shell and work out a simpler way to do it. Perhaps not...
  22.  
  23. Makes you wonder why you bought a machine with a user-friendly 
  24. graphical user interface.
  25.  
  26. Maybe you should be using STree.
  27.  
  28.  
  29. STree is a desktop accessory for the Atari ST / STE / TT which 
  30. lets you search for files on your hard disk matching a 
  31. specification and then manipulate them using a TT style desktop.
  32.  
  33. Just click on STree in the accessory menu and up pops a dialog 
  34. box. You can then enter your search specification, including:-
  35.  
  36.     o File mask with full Unix(tm) style wildcarding.
  37.     o Drive partitions to search.
  38.     o Path to start searching from on each drive.
  39.     o Depth of folders to search down to.
  40.     o File attributes (read only, hidden, system & archive).
  41.     o Date stamp range.
  42.     o Time stamp range.
  43.     o File size range.
  44.     o ASCII or hex strings to search for within a file.
  45.  
  46.  
  47. STree will then begin its search, building up a list of matching 
  48. files. Once this is complete, a window will open containing the 
  49. list. From here you can carry out all the standard file 
  50. operations, just like the Desktop: copy, move, delete, print, 
  51. rename, change file attributes, text file view, saving and 
  52. printing the file list as well as being able to sort the list by 
  53. folder, filename, type, date and size. And there's the same 
  54. keyboard shortcuts you'll find on Atari's new desktop.
  55.  
  56.  
  57.  
  58.  
  59. A SUBTLE HINT
  60. -------------
  61.  
  62. STree is SHAREWARE. If you use STree then you are expected to 
  63. become a registered user by sending us a tenner.
  64.  
  65. If you register, then we'll try and help you with any problems 
  66. you may have with STree. We'll also be more likely to include 
  67. your suggestions for improvements in future versions. When new 
  68. versions are released you will be given priority treatment and 
  69. usually able to upgrade just by sending us a blank disk and 
  70. return postage.
  71.  
  72. If there is no shareware response to STree, then it's unlikely 
  73. that we'll be able to continue enhancing and supporting the 
  74. program (sniff).
  75.  
  76. Details of how to register are given at the end of this 
  77. document.
  78.  
  79.  
  80.  
  81.  
  82. SYSTEM REQUIREMENTS
  83. -------------------
  84.  
  85. System
  86.     STree should work on any ST, STE or TT.
  87.  
  88. Screen resolution
  89.     STree needs a screen resolution of at least 640 x 200.
  90.  
  91. Memory
  92.     STree will work in any memory size, but 1M+ is preferred. 
  93.     You may find that if STree is opened in some applications 
  94.     then there is not enough room in memory for a full list of 
  95.     files that match your specification. In this case, you will 
  96.     need to return to the Desktop to carry out your search.
  97.  
  98.     In its dormant state STree needs approximately 90K of 
  99.     memory. It is not possible to open the accessory if there is 
  100.     less than 24K free memory available. Each matching file 
  101.     STree finds takes up 88 bytes in memory and if you search 
  102.     for strings in files a 16K buffer is needed.
  103.  
  104.  
  105.  
  106.  
  107. INSTALLATION
  108. ------------
  109.  
  110. Copy STREE.ACC and its resource file STREE.RSC to your boot 
  111. drive (or wherever your other accessories reside). 
  112.  
  113. By default, STree uses UK style dates (DD/MM/YY). If you want to 
  114. use American style dates (MM/DD/YY), rename STREE.ACC to 
  115. STREE_US.ACC. If you want to use European style dates 
  116. (YY/MM/DD), rename STREE.ACC to STREE_EU.ACC.
  117.  
  118. Then, to activate the accessory, simply hit the reset button. If 
  119. STree cannot operate in the screen resolution, or if it cannot 
  120. find STREE.RSC then you will be informed with an alert and STree 
  121. will not appear in the Desk menu.
  122.  
  123.  
  124.  
  125.  
  126. SPECIFYING A SEARCH
  127. -------------------
  128.  
  129. Clicking on the STree entry in the Desk menu will bring up the 
  130. STree specification dialog box. This contains a number of fields 
  131. and buttons as described below. All of these can, of course, be 
  132. used in combination with each other.
  133.  
  134.  
  135. Search mask
  136.  
  137.     This is the filename to search for, including wildcards. The 
  138.     first time STree is used in each session this will be set to 
  139.     '*.*' (search for everything).
  140.  
  141.     The wildcards operate in a slightly different way to the 
  142.     normal GEMDOS method. '*' will match any string of 
  143.     characters, or no characters at all. '?' will match any 
  144.     single character. (Under GEMDOS '*' will match any 
  145.     characters up to the '.' separator or the end of the 
  146.     filename and '?' will match any single character or, before 
  147.     a separator or end of name, no characters.) This is best 
  148.     explained with examples.
  149.  
  150.         *.*         - Match any filename.
  151.         *.DOC       - All files with type DOC.
  152.         FRED.*      - Files with name FRED and any type.
  153.         FRED*.*     - Files which begin with FRED.
  154.         *FRED.*     - Files with FRED at any position in the 
  155.                     name but nothing following and any type.
  156.         *FRED*.DOC  - Files with FRED at any position in the 
  157.                     name and the type DOC.
  158.         *.?         - Files with a single character type.
  159.         *.?*        - Files with a type one character long or 
  160.                     more.
  161.         *FRED??.DOC - Files with FRED at any position in the 
  162.                     name followed by two characters and the 
  163.                     type DOC.
  164.         *FRED*      - Files with name FRED anywhere in the name 
  165.                     and no type.
  166.  
  167.     This method of wildcarding is of much more use when 
  168.     searching for a file, and apart from '?' wildcards is fully 
  169.     compatible with GEMDOS operation.
  170.  
  171.  
  172. Drives
  173.  
  174.     These buttons select which drives you wish to search. Drives 
  175.     which do not exist are disabled. At the start of the session 
  176.     all hard disk drives will be selected.
  177.  
  178.  
  179. Path
  180.  
  181.     This is the path at which you wish to start searching on 
  182.     each drive. If the chosen path does not exist on a drive, 
  183.     then it will be bypassed in the search.
  184.  
  185.     Clicking on the path will bring up the file selector. This 
  186.     will be positioned at the first drive selected on the 
  187.     specification dialog box and the current path. Normally you 
  188.     will only want to search a path on one drive. Anticipating 
  189.     this, all other drive buttons will be deselected after 
  190.     clicking on OK in the file selector.
  191.  
  192.  
  193. Attributes
  194.  
  195.     You can search for files with particular attributes. Under 
  196.     TOS 1.4 and above these are as follows:-
  197.  
  198.         Archive     When a file is created or modified the 
  199.                     Archive attribute will be set. A hard disk 
  200.                     backup program will normally reset this bit 
  201.                     when the file has been backed up.
  202.         System      When set, a file will not appear on the 
  203.                     Desktop or in the file selector as long as 
  204.                     the Read Only or Archive attributes are not 
  205.                     set.
  206.         Hidden      As for System.
  207.         Read Only   When set, a file cannot be deleted or 
  208.                     written to.
  209.  
  210.     Files can be retrieved which have an attribute Set, Reset or 
  211.     Both - corresponding the [S], [R] and [B] buttons.
  212.  
  213.  
  214. Bytes
  215.  
  216.     You can search for files that contain a particular ASCII or 
  217.     hexadecimal string.
  218.  
  219.     To search for an ASCII string, the [ASCII] radio button must 
  220.     be selected and the string entered in the Bytes field. If 
  221.     the string is entirely in upper case letters then the search 
  222.     is done case blind. e.g. If you enter the string 'ATARI' 
  223.     then 'Atari', 'ATARI' and 'atari' will all match. If you 
  224.     enter the string 'Atari' then only 'Atari' will match.
  225.  
  226.     To search for a hexadecimal string, the [HEX] radio button 
  227.     must be selected. The hex string must be of even length - 
  228.     add a leading zero if necessary. e.g. '01FE30' rather than 
  229.     '1FE30'.
  230.  
  231.     If the [Present] radio button is selected, then files 
  232.     containing the string will be retrived. If the [Not Present] 
  233.     radio button is selected, then files that don't contain the 
  234.     string will be retrieved.
  235.  
  236.  
  237. Date and Time
  238.  
  239.     You can search for files that were modified between 
  240.     particular dates and / or times. There are several options 
  241.     for specifying the range of dates and times:-
  242.  
  243.         Files modified      Enter the date in the From __/__/__ 
  244.         after a date        field. You can also specify a time 
  245.                             as well in the From __:__ field if 
  246.                             required. e.g From 02/10/90 will 
  247.                             retrieve all files modified after 
  248.                             02/10/90.
  249.  
  250.         Files modified      Enter the date in the To __/__/__ 
  251.         before a date       field. You can also specify a time 
  252.                             as well in the From __:__ field if 
  253.                             required. e.g. To 12:00 09/10/90 
  254.                             will retrieve all files modified 
  255.                             before midday on 09/10/90.
  256.  
  257.         Files modified      Enter the start date in the From
  258.         between two dates   __/__/__ field and the end date in 
  259.                             the To __/__/__ field. You can also 
  260.                             specify times on those particular 
  261.                             days if required. e.g. From 
  262.                             02/10/90, To 12:00 09/10/90 will 
  263.                             retrieve files modified between 
  264.                             midnight on 02/10/90 and midday on 
  265.                             09/10/90. From 16:00 05/10/90, To 
  266.                             17:00 05/10/90 will retrieve files 
  267.                             modified between 4pm and 5pm on 
  268.                             05/10/90.
  269.  
  270.         Files modified      Enter the start time in the From
  271.         after a time        __:__ field. e.g. From 09:00 will
  272.         on any day          retrieve all files that were 
  273.                             modified after 9am.
  274.  
  275.         Files modified      Enter the end time in the To __:__
  276.         before a time       field. e.g. To 22:30 will retrieve 
  277.         on any day          all files that were modified before 
  278.                             10:30pm.
  279.  
  280.         Files modified      Enter the start time in the From:
  281.         between two times   __:__ field and the end time in the
  282.         on any day          To __:__ field. e.g. From 01:45 To 
  283.                             02:00 will retrieve files modified 
  284.                             between 1:45am and 2am.
  285.  
  286.     See INSTALLATION for details of how to set the date format 
  287.     for your country, if necessary.
  288.  
  289.  
  290. Size
  291.  
  292.     You can search for files on the basis of their size. To 
  293.     retrieve files greater than a particular size, enter it in 
  294.     the From ________ field. To retrieve files less than a 
  295.     particular size, enter it in the To ________ field. You can 
  296.     specify a range of sizes by entering both values.
  297.  
  298.  
  299. Depth
  300.  
  301.     This specifies how deep you wish to search from the start 
  302.     path. e.g. If the path is '\' and the depth is specified as 
  303.     0 then only files residing in the root directories will be 
  304.     retrieved. If the path is '\STREE' and the depth is 2, then 
  305.     files will be retrieved from STREE itself, files in a 
  306.     directory below STREE and files in a directory below that. 
  307.     You can search a maximum of 10 levels deep.
  308.  
  309.  
  310. Info
  311.  
  312.     This button displays the STree information dialog box, with 
  313.     details of our address and brief shareware details.
  314.  
  315.  
  316. Scan
  317.  
  318.     This button begins the scanning of the drives for files 
  319.     matching your specification. If there are any errors in the 
  320.     specification (invalid dates, no search mask, no drives 
  321.     selected, etc.) then an alert will inform you of the problem 
  322.     and you will not be able to proceed with the scan.
  323.  
  324.  
  325. Exit
  326.  
  327.     This button returns you to your currently running 
  328.     application or the GEM Desktop.
  329.  
  330.  
  331.  
  332.  
  333. SEARCHING
  334. ---------
  335.  
  336. Once you have clicked on the [SCAN] button, or pressed <RETURN> 
  337. STree will begin scanning the selected drives for files matching 
  338. your specification. As each new folder is accessed, its path 
  339. will be displayed on the screen. If you are searching for a 
  340. string in a file, then the time the scan takes will be much 
  341. longer than normal. At any time during the scan, you can press 
  342. <UNDO> to abort the scanning operation. This will bring up an 
  343. alert box to check that you do really want to do this.
  344.  
  345. If there are no files matching your specification then this will 
  346. be reported and you will return to the specification dialog box. 
  347. If there is not enough memory to hold the full list of matching 
  348. files then you will be informed of this, and can then manipulate 
  349. those files that were able to be retrieved.
  350.  
  351.  
  352.  
  353.  
  354. STREE DESKTOP
  355. -------------
  356.  
  357. When one or more files have been found which match your 
  358. specification a window will be opened containing the STree 
  359. Desktop. This has been designed to be as similar to the GEM 
  360. Desktop (or rather the new Desktop on the TT and STE) as 
  361. possible, so using it should be second nature. Most operations 
  362. are loop-alike: when more than one item is selected, the 
  363. operation is carried out on each in turn; when the operation on 
  364. each item is successfully completed, the item is deselected.
  365.  
  366.  
  367. Note that it is not possible to top other windows or select menu 
  368. items whilst STree is open. However, all the normal window 
  369. handles can be used. (This restriction has been imposed because 
  370. of problems dynamically allocating memory during an accessory 
  371. session with early TOSes.)
  372.  
  373.  
  374. The main part of the screen contains the list of files. Each 
  375. file entry (or item) shows first the path then the name, type, 
  376. size, date and time. If the path is too long then not all of 
  377. these may be present.
  378.  
  379. Above this is the info line. When no items are selected this 
  380. shows the total number of items in the list and their combined 
  381. size. If one or more items are selected then this shows the 
  382. number of selected items and their combined size.
  383.  
  384. To the left of the window is a block containing three icons and 
  385. two menu titles. Items dragged to the icons carry out their 
  386. respective functions. The two menus are spring-loaded pop-ups. 
  387. Pressing the mouse down on a title results in the appropriate 
  388. menu appearing. The mouse can then be dragged until it is over 
  389. the required choice and released. All the various functions 
  390. available are described below.
  391.  
  392.  
  393. Selecting items
  394.  
  395.     Selecting items is almost exactly the same as the GEM 
  396.     Desktop. Clicking on an item selects it and deselects all 
  397.     other items. Clicking on an item whilst pressing <SHIFT> 
  398.     toggles that item between selected and deselected whilst 
  399.     leaving all other items unaffected. You can rubber-band 
  400.     items by holding the mouse down and dragging from between 
  401.     items or away from the items but still in the white space. 
  402.     This will select all the items you loop, and deselect all 
  403.     others. Pressing <SHIFT> down at the same time will prevent 
  404.     other items being deselected. Unlike the original Desktop on 
  405.     the ST, scrolling the window will not deselect the items it 
  406.     contains.
  407.  
  408.     To make all the items in the list selected, choose the 
  409.     'Select all' option from the File menu or press <E>. To make 
  410.     all the items in the list deselected, click outside the 
  411.     items area or press <RETURN>.
  412.  
  413.  
  414. Sort by
  415.  
  416.     From the View menu you can choose how items are sorted: by 
  417.     folder, name, type, date and size. The currently selected 
  418.     sort is checked. When you first enter the STree Desktop, 
  419.     files are sorted by folder. If you have a long list of 
  420.     files, the sorting make take several seconds.
  421.  
  422.  
  423. Open file
  424.  
  425.     You can view a text file by double clicking on an item. 
  426.     Alternatively you can select an item then choose the 'Open 
  427.     file' option from the File menu or press <O>.
  428.  
  429.     When the screen is full you will get a '-- More --' prompt. 
  430.     Pressing <Q>, <CONTROL><C>, <UNDO> or the right mouse button 
  431.     will return you to the STree Desktop. Pressing <D> or 
  432.     <CONTROL><D> will scroll by half a page. Pressing <RETURN> 
  433.     will scroll by one line. Pressing <SPACE> or the left mouse 
  434.     button will display the next page. At the end of the file, 
  435.     you will be presented with the '-- End of file --' prompt. 
  436.     Pressing any key or mouse button will return you to the 
  437.     STree Desktop.
  438.  
  439.  
  440. Show info
  441.  
  442.     To show information about a file or files, select one or 
  443.     more items then choose the 'Show info...' option from the 
  444.     File menu or press <S>. You will be presented with a dialog 
  445.     box showing the filename, size, date and time last modified 
  446.     and its attributes.
  447.  
  448.     You can change the filename by entering a new name in the 
  449.     field. You can change an attribute by clicking on the 
  450.     appropriate buttons. Clicking on the [OK] button will modify 
  451.     the name and / or attributes. [Skip] will leave this file 
  452.     untouched and still selected and move on to the next item. 
  453.     [Cancel] will return you to the STree Desktop.
  454.  
  455.  
  456. Copy file(s)
  457.  
  458.     To copy one or more files, select the required items and 
  459.     drag them to the Disk icon. A dialog box will appear 
  460.     confirming the copy operation and the number of items to 
  461.     copy. Clicking on [OK] will present the file selector, from 
  462.     where you can choose the path to copy the files to. Clicking 
  463.     on [OK] again here will begin the copy operation. As each 
  464.     file is copied its filename is displayed on the screen. You 
  465.     can abort the operation at any time by pressing <UNDO>.
  466.  
  467.     If a file already exists, then you are given the option to 
  468.     change the destination filename. Clicking on [OK] will copy 
  469.     using the name in the destination filename field. [Skip] 
  470.     will skip copying this file and leave it still selected. 
  471.     [Cancel] will abort the entire copy operation. Note that if 
  472.     you overwrite a file that is present elsewhere in the list 
  473.     then that item will not be updated with the new file 
  474.     details! If this happens you should do another scan.
  475.  
  476.  
  477. Move file(s)
  478.  
  479.     The process of moving a file or files is almost identical to 
  480.     Copy file(s). Select the required item(s) and drag them to 
  481.     the Disk icon, holding down the <CONTROL> key when you 
  482.     release the mouse button. The dialog will confirm that you 
  483.     have chosen to move rather than copy. At the end of the move 
  484.     operation, the pathnames of the files will have been updated 
  485.     with the new path at which they reside.
  486.  
  487.  
  488. Delete file(s)
  489.  
  490.     To delete one or more files, select the required items and 
  491.     drag them to the Trash icon. A dialog box will appear 
  492.     confirming the delete operation and the number of items. 
  493.     Clicking on [OK] will begin the deletion of the files. As 
  494.     each file is deleted, its filename is displayed on the 
  495.     screen. You can abort the operation at any time by pressing 
  496.     <UNDO>. At the end of the delete, the files are removed from 
  497.     the item list. If there are no items left then you will be 
  498.     presented with an empty desktop.
  499.  
  500.  
  501. Print file(s)
  502.  
  503.     To print one or more files, select the required items and 
  504.     drag them to the Printer icon. A check will be made that the 
  505.     printer is online, allowing you to switch it on or return to 
  506.     the desktop if it isn't. As each file is printed, its 
  507.     filename is displayed on the screen. At the end of each 
  508.     file, a form-feed will be output. You can abort the 
  509.     print operation at any time by pressing <UNDO>.
  510.  
  511.  
  512. Save list
  513.  
  514.     You can save the file list to disk. Choose the 'Save list...' 
  515.     option from the File menu or press <W>. A file selector will 
  516.     appear from which you can select the path and filename for 
  517.     the list file. Each line in the file will be in the same 
  518.     format as the screen display.
  519.  
  520.  
  521. Print list
  522.  
  523.     You can print the file list on your printer. Choose the 
  524.     'Print list' option from the File menu or press '>' 
  525.     (<SHIFT><.>). Lines are printed in the same format as the 
  526.     screen display, with a maximum length of 80 characters.
  527.  
  528.  
  529. New list
  530.  
  531.     To return to the Specification dialog choose the 'New 
  532.     list...' option from the File menu or press <L>.
  533.  
  534.  
  535. Close list
  536.  
  537.     To return to your application or the GEM Desktop, choose the 
  538.     'Close list' option from the File menu or press <C>.
  539.  
  540.  
  541.  
  542.  
  543. DESKTOP OPERATION SUMMARY
  544. -------------------------
  545.  
  546. Copy file(s)            Drag items to disk icon
  547.  
  548. Move file(s)            Drag items to disk icon, holding <CONTROL>
  549.  
  550. Print file(s)           Drag items to printer icon
  551.  
  552. Delete file(s)          Drag items to trash icon
  553.  
  554. Open file       [O]     Menu selection. Double click on item.
  555.  
  556. Show info       [S]     Menu selection.
  557.  
  558. Select all      [E]     Menu selection.
  559.  
  560. Deselect items  <CR>    Click on desktop.
  561.  
  562. Save list       [W]     Menu selection.
  563.  
  564. Print list      [>]     Menu selection.
  565.  
  566. New list        [L]     Menu selection.
  567.  
  568. Close list      [C]     Menu selection. Click on close window.
  569.  
  570. Move up         <UP>    Click on up arrow.
  571.  
  572. Move down       <DOWN>  Click on down arrow.
  573.  
  574. Sort by folder          Menu selection.
  575.  
  576. Sort by name            Menu selection.
  577.  
  578. Sort by type            Menu selection.
  579.  
  580. Sort by date            Menu selection.
  581.  
  582. Sort by size            Menu selection.
  583.  
  584.  
  585.  
  586.  
  587. CONDITIONS OF USE
  588. -----------------
  589.  
  590. STree is SHAREWARE, copyright 1991 TQM Communications. All 
  591. rights reserved.
  592.  
  593. This program may be freely distributed provided the following 
  594. conditions are met. The STree program file, resource file and 
  595. this documentation must all be included. No charge, other than 
  596. basic online charges or media costs, may be levied. The program 
  597. file, resource file and this documentation must not be altered 
  598. in any way whatsoever. STree must not be sold or included with 
  599. any commercial product without the express written permission 
  600. of TQM Communications. This documentation must not be reprinted 
  601. without the express written permission of TQM Communications.
  602.  
  603. If you use this program, you are expected to become a 
  604. registered user by sending us a payment of 10 pounds sterling, 
  605. including VAT.
  606.  
  607.     STree Registrations
  608.     TQM Communications
  609.     BCM Box 225
  610.     London
  611.     WC1N 3XX
  612.     ENGLAND
  613.  
  614. Payment can be made by cheque, postal order or international 
  615. money order, made payable to 'TQM Communications'. We will also 
  616. accept banknotes in any currency at the current exchange rate, 
  617. but please be sure to wrap these safely.
  618.  
  619. If you require a VAT receipt, please enclose a self-addressed 
  620. envelope, with appropriate stamps if you are in the UK or an 
  621. International Reply Coupon elsewhere in the world.
  622.  
  623.  
  624.  
  625.  
  626. DISCLAIMER
  627. ----------
  628.  
  629. TQM Communications makes no warranty of any kind in respect to 
  630. this documentation and the software described. The user assumes 
  631. any risk as to the quality and performance of this product. In 
  632. no event will TQM Communications be liable for direct, 
  633. indirect, incidental or consequential damages arising from any 
  634. defect in the performance and use of this product.
  635.  
  636. All trademarks acknowledged.
  637.  
  638.  
  639.  
  640.  
  641. HISTORY
  642. -------
  643.  
  644. V1.00 - 28 Mar 91
  645.  
  646.     Initial release.
  647.  
  648.  
  649. V1.01 - 10 Apr 91
  650.  
  651.     Minor improvement of scanning efficiency.
  652.  
  653.  
  654. V1.02 - 5 May 91
  655.  
  656.     Under TOS 1.04 onwards, the file selector will append a 
  657.     '*.*' if a wildcard wasn't supplied. STree will now 
  658.     accomodate for this. Previously it prevented the setting of 
  659.     a search path and a copy / move destination path so those 
  660.     functions did not work.
  661.  
  662.     If a file is deleted and the slider is at the bottom of the 
  663.     list, then it will now be correctly repositioned afterwards.
  664.  
  665.     Viewing a file is now faster, with improved mouse operation. 
  666.     The computer will no longer crash if ^C is pressed whilst 
  667.     the screen is filling.
  668.  
  669.  
  670. ---- END OF DOCUMENTATION
  671.  
  672.